home *** CD-ROM | disk | FTP | other *** search
/ iBrowse Update Disc / iBrowse Update Disc.iso / distrib / man / Manuals / Timecode / USERGUIDE < prev   
Text File  |  1998-02-09  |  13KB  |  281 lines
  1. <HTML>
  2. <HEAD>
  3. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
  4. <TITLE>Acorn TimeCode User Guide</TITLE>
  5.  
  6. <META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.04z">
  7. </HEAD>
  8. <BODY BGCOLOR="#ffffff">
  9. <A HREF="CONTENTS"><IMG SRC="pics/PREV" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  10. <A HREF="FRONT"><IMG SRC="pics/FRONT" HEIGHT="28" WIDTH="96" BORDER="0"></A> <A HREF="CONTENTS"><IMG SRC="pics/CONTS" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  11. <A HREF="PRM"><IMG SRC="pics/NEXT" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  12. <H1>1. Acorn TimeCode User Guide<A NAME="Top"></A></H1>
  13. <HR>
  14. <H2><A NAME="Overview">Overview</A></H2>
  15. <P>
  16. <FONT SIZE=3>Multimedia hardware devices and software applications
  17. which can store, manipulate and present time based data such as
  18. animations, video, audio, MIDI and presentation timelines can
  19. be synchronised by the Acorn TimeCode subsystem using industry
  20. standard MTC timecodes. This provides the application developer
  21. and end user with a seamless, easy to use interface which eases
  22. the development of broadband multimedia presentations. </FONT>
  23. <P>
  24. <FONT SIZE=3>By using this software a RISC OS application or a
  25. hardware device attached to a Risc PC can receive, generate or
  26. propagate a high resolution time stream. The direction and rate
  27. at which time flows across the timestream can be controlled by
  28. the application or hardware device, and the timestream may be
  29. routed from the application to other hardware or software clients.
  30. </FONT>
  31. <P>
  32. <FONT SIZE=3>The RISC OS computer system now becomes capable of
  33. synchronising with or controlling a range of other devices which
  34. also have an awareness of time. Examples of these devices include
  35. MIDI sequencers, synthesisers, samplers and multitrack tape decks,
  36. and CD-ROM drives and other computer systems. </FONT>
  37. <P>
  38. <FONT SIZE=3>Suitable interface hardware (such as a MIDI card)
  39. is used to allow reception and transmission of the time stream
  40. from and to external sources. </FONT>
  41. <P>
  42. <FONT SIZE=3>The TimeCode subsystem provides support for full
  43. and quarter frame MTC, and the 75fps frame addressing of Red Book
  44. audio CD. In addition to these default rates, frame rates from
  45. 1fps to 1800fps are supported. </FONT>
  46. <P>
  47. <FONT SIZE=3>Timecode can be routed between applications with
  48. on-the-fly conversion of differing frame rates. It is possible
  49. for instance, to use the 75 fps timing on an audio CD to produce
  50. MTC streams at 30 fps. Here, the CD could act as the timing source
  51. for the MIDI system. Other time-aware devices such as sequencers
  52. can follow the time stream from the CD and are therefore synchronised
  53. with it. </FONT>
  54. <P>
  55. <FONT SIZE=3>TimeCode is currently being developed by Acorn Risc
  56. Technologies. </FONT>
  57. <P>
  58. <FONT SIZE=3>The software provided here is all pre-beta. We believe
  59. it is stable enough to be used, but should be considered to be
  60. provided 'as is'. Reports of any problems, bugs, or comments may
  61. be emailed to : </FONT>
  62. <P>
  63. <FONT SIZE=3>skynet-comment@art.acorn.co.uk </FONT>
  64. <P>
  65. <FONT SIZE=3>Wishlist items can be sent as plain text. Other reports
  66. should use the FaultRept template in the Doc directory. </FONT>
  67. <H2><A NAME="Requirements">Requirements</A> </H2>
  68. <P>
  69. <FONT SIZE=3>!Karaoke was written using Desktop C; and requires
  70. RISC_OSLib. The other applications were written using Acorn C/C++
  71. and require the various toolbox modules rmensured in each !Run
  72. file plus TinyStubs. </FONT>
  73. <H2><A NAME="Software">Software</A> structure </H2>
  74. <H3><A NAME="Apps">Apps</A></H3>
  75. <P>
  76. A directory containing various TimeCode-aware applications: 
  77. <H3>!<A NAME="CD">CD</A>-Deck </H3>
  78. <P>
  79. <FONT SIZE=3>This application can control a CD-ROM drive. If used
  80. with a conventional audio CD it can read the timecode stream present
  81. on every audio (Red Book) CD and use it to update the TimeCode
  82. system's Internal Clock. </FONT>
  83. <P>
  84. <FONT SIZE=3>Click Select on the icon bar icon to open the CD
  85. Player window. </FONT>
  86. <P>
  87. <FONT SIZE=3>This window contains five buttons, which have these
  88. functions (reading from left to right): </FONT>
  89. <UL>
  90. <LI>Decrement programmed track number 
  91. <LI>Start CD playing from programmed track number 
  92. <LI>Pause (Click on Pause again to release) 
  93. <LI>Increment programmed track number 
  94. <LI>Eject CD 
  95. </UL>
  96. <P>
  97. The display field to the right of the buttons shows the current
  98. time from the CD, in mm:ss:ff format. Hours are also displayed
  99. when necessary. 
  100. <P>
  101. The display field below the icons gives a status indication for
  102. the application and the CD-ROM transport. 
  103. <H3>!<A NAME="Karaoke">Karaoke</A> </H3>
  104. <P>
  105. <FONT SIZE=3>This application can be used to display time-synchronised
  106. information. Unlike the other applications here it only works
  107. to second resolution; it was originally conceived for displaying
  108. the words to a song (using the timecode stored on an audio CD).
  109. However, it has many more applications than that - anything which
  110. involves time-synchronised information. In the example here we've
  111. used it to display some explanation about the uses of timecode.
  112. You'll see that it begins at 00:58:00:00 - this is a default starting
  113. time within the audio/video industry; though it's usually the
  114. start of two minutes of lead-in rather than directly into programme
  115. information as here. </FONT>
  116. <P>
  117. <FONT SIZE=3>The name of the file to use is given in the !Run
  118. file. The layout of the file indicates its original design - the
  119. first line of the file must contain a time and a [Album] tag.
  120. The content of this line is placed on the top line of the window.
  121. This is then followed by one or more [Track] lines which give
  122. the name for a given track; that is - what to display on line
  123. two of the display. </FONT>
  124. <P>
  125. <FONT SIZE=3>One other special line is supported - [Quit] which
  126. can be used to make !Karaoke exit. </FONT>
  127. <P>
  128. <FONT SIZE=3>All other lines will consist of a time stamp in hh
  129. mm ss followed by the text (if any) to display. </FONT>
  130. <P>
  131. <FONT SIZE=3>The display consists of a number of lines in light
  132. blue, with the current line in dark blue. </FONT>
  133. <P>
  134. <FONT SIZE=3>!Karaoke will follow timecode wherever it goes; automatically
  135. adjusting direction or taking account of jumps in time. Put simply
  136. it makes no assumptions about the direction or speed of time flow.
  137. This is an essential point to note about timecode; it cannot be
  138. guaranteed to be advancing forwards monotonically; indeed it could
  139. be going backwards or not moving at all - and if moving may well
  140. not be doing so at real time. </FONT>
  141. <H3>!<A NAME="Scheduler">Scheduler</A> </H3>
  142. <P>
  143. <FONT SIZE=3>This is basic example of an event scheduler built
  144. to operate on timecode. It provides minimal editing facilities,
  145. and its display is not very graphical - it was written to demonstrate
  146. the potential of the concept rather than be the last word in showing
  147. it. </FONT>
  148. <P>
  149. <FONT SIZE=3>The textual files inside the directory describe the
  150. file format for the event file. When it starts up it reads in
  151. the file !Scheduler.Default, and it saves the modified data as
  152. !Scheduler.Output when the application exits. </FONT>
  153. <P>
  154. <FONT SIZE=3>You are advised to open the display window by clicking
  155. Select on the icon bar icon - this improves the response. </FONT>
  156. <P>
  157. <FONT SIZE=3>The default file included with this version is the
  158. schedule file used to animate the Acorn Conductor at Acorn World
  159. - timecode was drawn from an audio CD and the scheduler issued
  160. pollword changes to the application responsible for animating
  161. the Acorn Conductor. </FONT>
  162. <H3>!<A NAME="TimeShare">TimeShare</A> </H3>
  163. <P>
  164. <FONT SIZE=3>This application is provided to allow control of
  165. the timecode system from the desktop environment. It allows clock
  166. and clock transmitter selection; provides control over the Internal
  167. Clock and provides diagnostic facilities such as a switchable
  168. display of the current timecode at a fps rate chosen by the user.
  169. </FONT>
  170. <P>
  171. <FONT SIZE=3>Note that changes will not take effect until OK is
  172. clicked upon, and certain controls will have a transitional state
  173. where you cannot make further changes because a change is already
  174. pending (for example starting the Internal Clock). </FONT>
  175. <H3>!<A NAME="TimeSpeed">TimeSpeed</A> </H3>
  176. <P>
  177. <FONT SIZE=3>This application provides a finer control over the
  178. Internal Clock. You may have as many copies of this application,
  179. !TimeShare or !Karaoke as you wish loaded and they will all stay
  180. in step with each other. </FONT>
  181. <P>
  182. <FONT SIZE=3>You will notice this particularly with !TimeSpeed.
  183. The display field gives the rate that the Internal Clock is running
  184. at in comparison to real time. If you have more than one invocation
  185. of !TimeSpeed running you will see they all remain locked to one
  186. another. </FONT>
  187. <P>
  188. <FONT SIZE=3>Most of the buttons are multi-purpose - reading from
  189. left to right they operate as follows: </FONT>
  190. <UL>
  191. <LI>Fast Back: 
  192. <UL>
  193. <LI>Select: increase by x1 reverse 
  194. <LI>Adjust: decrease by x1 reverse (will drop to Rev. Play at
  195. 1x reverse) 
  196. </UL>
  197. <LI>Rev. Play: 
  198. <UL>
  199. <LI>Select: set to 1x reverse 
  200. <LI>Adjust: reduce by 0.1x reverse 
  201. </UL>
  202. <LI>Stop: Select: stop time flow, cancel pause mode 
  203. <LI>Play: as Rev. 
  204. <LI>Play, but for forwards flow 
  205. <LI>Fast Fwd: as Fast Back, but for forwards flow 
  206. <LI>Pause: enter/leave Pause mode. When in Pause mode the functions
  207. of the other buttons change: 
  208. <UL>
  209. <LI>Fast Back: back by 1 second 
  210. <LI>Rev. Play: back by 1 frame 
  211. <LI>Stop: Exit Pause mode 
  212. <LI>Play: forward by 1 frame 
  213. <LI>Fast Fwd: forward by 1 second 
  214. </UL>
  215. </UL>
  216. <P>
  217. The display field next to the buttons is used to display the current
  218. time flow, and the display field at the right of the window shows
  219. the current timecode value expressed in 25fps. 
  220. <H2><A NAME="Useful">Useful</A> Documents </H2>
  221. <H3><A NAME="FaultRep">FaultRep</A> </H3>
  222. <P>
  223. <FONT SIZE=3>Fill out this template and send it as email to skynet-comment@art.acorn.co.uk.
  224. Try to give as much information in as impartial fashion as possible.
  225. If we can't reproduce a problem due to insufficient information
  226. we stand little chance of fixing it! </FONT>
  227. <H3><A NAME="Futures">Futures</A></H3>
  228. <P>
  229. contains an indication about what we're thinking of for the future
  230. <H3>Futures.<A NAME="Control">Control</A> </H3>
  231. <P>
  232. <FONT SIZE=3>This is an internal *draft* document giving a proposed
  233. wimp message interface to allow applications which handle resources
  234. which are timecode-aware to interface with a application/resource
  235. manager which would handle all the interlinking between all such
  236. applications and resources. Amongst other things it could remove
  237. the need for most every application to have a tape-transport style
  238. of its own which is subtly different to every other one. </FONT>
  239. <H3><A NAME="MergeBoot">MergeBoot</A> </H3>
  240. <P>
  241. <FONT SIZE=3>These are supplementary and replacement items for
  242. !Boot </FONT>
  243. <P>
  244. <FONT SIZE=3>See the ReadMe file for additional information. RISC
  245. OS 3.10 users should manually update their !System to have the
  246. same structure as is represented within the !Boot.!Resources.!System
  247. here. </FONT>
  248. <P>
  249. <FONT SIZE=3>Note that this is NOT a replacement !Boot for RISC
  250. OS 3.50 or RISC OS 3.60 users - it contains additional and updated
  251. items which must be merged correctly with your existing !Boot
  252. structure. </FONT>
  253. <H3><A NAME="TimeLib">TimeLib</A> </H3>
  254. <P>
  255. <FONT SIZE=3>This is a timecode interface library for C </FONT>
  256. <P>
  257. <FONT SIZE=3>This directory contains the TimeLib library and its
  258. associated header file. </FONT>
  259. <P>
  260. <FONT SIZE=3>This library provides a simple interface to all the
  261. SWIs which are provided by the TimeShare module. By supplying
  262. a library only those functions you need will be incorporated in
  263. the object code. Note that wimplib is also needed. </FONT>
  264. <P>
  265. <B><FONT SIZE=3>IMPORTANT</FONT></B>
  266. <P>
  267. <B><FONT SIZE=3>This material is provided for personal use only.
  268. If you wish to include the TimeShare module, or anything else
  269. here, in distributed code you should contact ART for licensing
  270. terms. Although the software here is in an advanced state, we
  271. reserve the right to make any changes to the software or its interfaces
  272. we deem necessary or desirable. If you are considering building
  273. a product using this technology you are advised to contact ART
  274. for advice beforehand. </FONT></B>
  275. <P>
  276. <A HREF="CONTENTS"><IMG SRC="pics/PREV" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  277. <A HREF="FRONT"><IMG SRC="pics/FRONT" HEIGHT="28" WIDTH="96" BORDER="0"></A> <A HREF="CONTENTS"><IMG SRC="pics/CONTS" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  278. <A HREF="PRM"><IMG SRC="pics/NEXT" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  279. </BODY>
  280. </HTML>
  281.